* appendfiles 范例
* Version 1.2 12Jan2019 by Yujun Lian, Zhonghao Wei

copy "https://gitee.com/arlionn/appendfiles/raw/master/appendfiles_eg.zip" appendfiles_eg.zip, replace     
unzipfile appendfiles_eg.zip, replace
cd appendfiles_eg

appendfiles "`c(pwd)'"
* 合并当前工作路径 "`c(pwd)'" (本例中为 appendfiles_eg 文件夹)内的所有.txt文档；
* 未用saving()定义保存的文档名或路径，默认在工作路径内保存为 appendfiles_output.txt。
* Appends all.txt files in the "`c(pwd)'" directory, which is the "appendfiles_eg"
* folder in this example. Since the user did not specify the saving .txt filename
* and the saving directory, the default filename of the generated .txt file is
* "appendfiles_output.txt". Also, the default saving directory is the same as the 
* user has inputted, which is the "appendfiles_eg" folder in this example.

* appendfiles "`c(pwd)'"
* 第 1 个文件是： FIN_Audit[DES][txt].txt
* 第 2 个文件是： Indus[DES][xlsx].txt
* 第 3 个文件是： IPO_Cobasic[DES][xlsx].txt
* 第 4 个文件是： PRI_Basic[DES][xlsx].txt
* 整合后的文件已保存为 appendfiles_output.txt
* 未指定输出路径，整合后的文件输出至原文件夹中


*---------------------------------------------------------------------------------------------


cap erase appendfiles_output.txt
appendfiles "`c(pwd)'", saving(Define_Output_Name)
* 合并当前工作路径 "`c(pwd)'" (本例中为 appendfiles_eg 文件夹)内的所有.txt文档；
* 使用saving()定义保存的文档名为 Define_Output_Name，将生成Define_Output_Name.txt
* 未用saving()定义保存的路径，默认在工作路径内保存输出的文档。
* Appends all.txt files in the "`c(pwd)'" directory, which is the "appendfiles_eg"
* folder in this example. The user has specify the name of the output .txt file
* as "Define_Output_Name", so "Define_Output_Name.txt" would be generated.
* Since the user did not specify the saving directory, "Define_Output_Name.txt" would
* be saved at the inputted directory, which is the folder "appendfiles_eg".

* appendfiles "`c(pwd)'", saving(Define_Output_Name)
* 第 1 个文件是： FIN_Audit[DES][txt].txt
* 第 2 个文件是： Indus[DES][xlsx].txt
* 第 3 个文件是： IPO_Cobasic[DES][xlsx].txt
* 第 4 个文件是： PRI_Basic[DES][xlsx].txt
* 整合后的文件已保存为 Define_Output_Name.txt
* 未指定输出路径，整合后的文件输出至原文件夹中


*---------------------------------------------------------------------------------------------


cap erase appendfiles_output.txt
cap erase Define_Output_Name.txt
appendfiles "`c(pwd)'", saving(`c(pwd)'\OutDirectory\OutputFile)

* 在V.1.2版本中，若saving()中输入的内容含有中文，可能导致报错甚至无法运行。
* Notice: In Version 1.2, if user inputs Chinese characters in saving(), the
* program may not work normally. English is more preferred.

* 合并当前工作路径 "`c(pwd)'" (本例中为 appendfiles_eg 文件夹)内的所有.txt文档；
* 使用saving()定义保存的路径为 appendfiles_eg 文件夹内的 OutDirectory 文件夹。
* 因为 OutDirectory 文件夹尚未存在，本程序将生成该文件夹。但是当 saving() 输入的
* 内容包括中文时，V.1.2版本可能报错。
* 注意，saving()里面最后的 \ 以后的内容将作为保存的文档名，此例中为 OutputFile，
* 于是生成的 OutpufFile.txt 将保存在 appendfiles_eg 文件夹下的 OutDirectory 文件夹中。
* Appends all.txt files in the "`c(pwd)'" directory, which is the "appendfiles_eg"
* folder in this example. The user has specify the saving directory as the folder
* "OutDirectory" inside the folder "appendfiles_eg". Since folder "OutDirectory"
* has not been created, the program would create such folder.
* Note that the content after the last "\" in saving() would be recognized as 
* the name of the output .txt file, which is "OutputFile" in this example.
* So, the generated "OutpufFile.txt would" be saved in the folder "OutDirectory" 
* inside the folder "appendfiles_eg".

* appendfiles "`c(pwd)'", saving(`c(pwd)'\OutDirectory\OutputFile)
* 第 1 个文件是： FIN_Audit[DES][txt].txt
* 第 2 个文件是： Indus[DES][xlsx].txt
* 第 3 个文件是： IPO_Cobasic[DES][xlsx].txt
* 第 4 个文件是： PRI_Basic[DES][xlsx].txt
* 整合后的文件已保存为 C:\Users\wwwww\stata15\ado\personal\appendfiles_eg\OutDirectory\OutputFile.txt


*---------------------------------------------------------------------------------------------


cap erase appendfiles_output.txt
cap erase Define_Output_Name.txt
appendfiles "`c(pwd)'", saving(`c(pwd)'\DirectoryOnly\)

* 在V.1.2版本中，若saving()中输入的内容含有中文，可能导致报错甚至无法运行。
* Notice: In Version 1.2, if user inputs Chinese characters in saving(), the
* program may not work normally. English is more preferred.

* 合并当前工作路径 "`c(pwd)'" (本例中为 appendfiles_eg 文件夹)内的所有.txt文档；
* 使用saving()定义保存的路径为 appendfiles_eg 文件夹内的 DirectoryOnly 文件夹。
* 因为 DirectoryOnly 文件夹尚未存在，本程序将生成该文件夹。但是当 saving() 输入的
* 内容包括中文时，V.1.2版本可能报错。
* 注意，saving()里面最后的 \ 以后的内容将作为保存的文档名，此例中为空，将默认在
* 输出路径中保存为 appendfiles_output.txt。于是生成的 appendfiles_output.txt 将
* 保存在 appendfiles_eg 文件夹下的 DirectoryOnly 文件夹中。
* Appends all.txt files in the "`c(pwd)'" directory, which is the "appendfiles_eg"
* folder in this example. The user has specify the saving directory as the folder
* "DirectoryOnly" inside the folder "appendfiles_eg". Since folder "DirectoryOnly"
* has not been created, the program would create such folder.
* Note that the content after the last "\" in saving() would be recognized as 
* the name of the output .txt file, which is actually empty in this example, so 
* the default filename of the generated .txt file is "appendfiles_output.txt".
* The generated "appendfiles_output.txt" would be saved in the folder 
* "DirectoryOnly" inside the folder "appendfiles_eg".

* appendfiles "`c(pwd)'", saving(`c(pwd)'\DirectoryOnly\)
* 第 1 个文件是： FIN_Audit[DES][txt].txt
* 第 2 个文件是： Indus[DES][xlsx].txt
* 第 3 个文件是： IPO_Cobasic[DES][xlsx].txt
* 第 4 个文件是： PRI_Basic[DES][xlsx].txt
* 整合后的文件已保存为 C:\Users\wwwww\stata15\ado\personal\appendfiles_eg\DirectoryOnly\appendfiles_output.txt